<html>
<head><meta charset="utf-8"><title>doc aliases · t-libs · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/index.html">t-libs</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html">doc aliases</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="236734240"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236734240" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Josh Triplett <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236734240">(Apr 29 2021 at 19:49)</a>:</h4>
<p>I just posted <a href="https://github.com/rust-lang/rust/pull/84709">https://github.com/rust-lang/rust/pull/84709</a> , which adds a doc alias for <code>chdir</code>. We've had several discussions recently about the level of justification we should require before adding a doc alias. I'm hoping that that PR sets a good example for a threshold that I think we should consider reasonable.</p>



<a name="236779219"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236779219" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Lokathor <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236779219">(Apr 30 2021 at 03:09)</a>:</h4>
<p>in a far future, I'm imagining that you can pick your "previous language" from a dropdown in the settings and get doc aliases based on that. ArrayList searches turn up Vec, for example.</p>



<a name="236780375"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236780375" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Josh Triplett <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236780375">(Apr 30 2021 at 03:28)</a>:</h4>
<p><span class="user-mention" data-user-id="224471">@Lokathor</span> In this case, it isn't so much "previous language" as "operating system".</p>



<a name="236780381"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236780381" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Josh Triplett <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236780381">(Apr 30 2021 at 03:28)</a>:</h4>
<p>chdir is a UNIX (POSIX) thing.</p>



<a name="236781700"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236781700" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Lokathor <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236781700">(Apr 30 2021 at 03:50)</a>:</h4>
<p>I just assumed it was some C thing, since C and Unix are such close friends</p>



<a name="236821381"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236821381" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Mara <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236821381">(Apr 30 2021 at 11:36)</a>:</h4>
<p><span class="user-mention" data-user-id="239881">@Josh Triplett</span> i really think we should first write down a guideline before adding more. every time we accept a PR like this, we suddenly get many more PRs with similar additions for which we still don't have a guideline</p>



<a name="236821456"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236821456" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Josh Triplett <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236821456">(Apr 30 2021 at 11:37)</a>:</h4>
<p>Fair enough. We do need a policy.</p>



<a name="236980514"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236980514" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> bstrie <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236980514">(May 01 2021 at 16:20)</a>:</h4>
<p>it would be nice if rustdoc search results showed badges next to each item, sort of like how it displays "deprecated" and "experimental" badges next to items in the module-level docs. in addition to showing "deprecated" and "experimental" badges in the search results, it could also show an "alias" badge, and the search results page could also sort the results so that it displays in order 1) normal results, 2) aliased results, 3) deprecated results, 4) experimental results</p>



<a name="236980572"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236980572" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> bstrie <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236980572">(May 01 2021 at 16:20)</a>:</h4>
<p>that would take a lot of the edge off of the alias additions, IMO</p>



<a name="236980945"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236980945" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236980945">(May 01 2021 at 16:25)</a>:</h4>
<p>I'd take a pr for that :)</p>



<a name="236981066"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236981066" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236981066">(May 01 2021 at 16:26)</a>:</h4>
<p>I don't think always sorting deprecated and experimental things to the bottom is great though, that could be what you're looking for. Rustdoc has <em>lots</em> of search results especially for small queries</p>



<a name="236981203"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236981203" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> bstrie <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236981203">(May 01 2021 at 16:29)</a>:</h4>
<p>I tend to disagree, take a look at a search for "MAX": <a href="https://doc.rust-lang.org/std/index.html?search=max">https://doc.rust-lang.org/std/index.html?search=max</a> , where all the deprecated items are sorted above the non-deprecated items, which results in bad user experience. I see no reason for deprecated items to ever take precedence over their replacements; for the subset of people who actually want the deprecated items, they can scroll down, because the alternative is to penalize the people who are looking for the non-deprecated items, which seems counter-productive</p>



<a name="236981303"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236981303" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> bstrie <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236981303">(May 01 2021 at 16:30)</a>:</h4>
<p>but yes, I'd be happy to submit a PR adding badges to search results, but I'll probably need some mentoring since I've never touched rustdoc before. I'll take it into the rustdoc channel</p>



<a name="236983677"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236983677" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236983677">(May 01 2021 at 17:05)</a>:</h4>
<p><span class="user-mention" data-user-id="256342">@bstrie</span> that's because you searched for <em>exactly</em> max and there are lots of exact results. If you search for try there are lots of inexact results and sorting try! to the bottom makes it hard to find: <a href="https://doc.rust-lang.org/std/index.html?search=try">https://doc.rust-lang.org/std/index.html?search=try</a></p>



<a name="236983710"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236983710" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236983710">(May 01 2021 at 17:05)</a>:</h4>
<p>sorting exact results according to your idea seems fine though</p>



<a name="236983806"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236983806" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> bstrie <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236983806">(May 01 2021 at 17:06)</a>:</h4>
<p>I wasn't intending to disrupt the current hierarchy of results, i.e. first you display exact matches, then you display fuzzy matches. the deprecated etc. sorting would take place within each hierarchy</p>



<a name="236983829"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236983829" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236983829">(May 01 2021 at 17:06)</a>:</h4>
<p>ahhh that makes more sense</p>



<a name="236983888"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236983888" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> bstrie <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236983888">(May 01 2021 at 17:07)</a>:</h4>
<p>but first I'll implement the badges for deprecated/experimental, then the next step can be badges for aliases, then we can work out the sorting after those are in</p>



<a name="236984063"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236984063" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> bstrie <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236984063">(May 01 2021 at 17:09)</a>:</h4>
<p>the aforementioned hierarchy is relevant to this discussion; I might expect that an alias would only show up in search results based on exactly matching the alias, and not fuzzy matching the alias. this would reduce the cognitive cost of adding a ton of aliases</p>



<a name="236984990"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236984990" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> The 8472 <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236984990">(May 01 2021 at 17:23)</a>:</h4>
<p>I think the issue with aliases is that they lack context. It should be something like <code>doc(alias(name="chdir", from="posix"))</code></p>



<a name="236989743"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236989743" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Josh Triplett <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236989743">(May 01 2021 at 18:37)</a>:</h4>
<p><span class="user-mention" data-user-id="330154">@The 8472</span> I would love to see that.</p>



<a name="236989957"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236989957" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> bstrie <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236989957">(May 01 2021 at 18:41)</a>:</h4>
<p>Sure, the badge could easily contain that information. Something like "AKA in Python", "AKA in POSIX" (I'd avoid using the phrase "alias" literally to avoid any potential confusion with type aliases)</p>



<a name="236990726"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236990726" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> The 8472 <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236990726">(May 01 2021 at 18:53)</a>:</h4>
<p>There are multiple overloaded uses for alias. Stuff people might know from other languages or libraries but also general documentation help, e.g. there's one for <code>+=</code> on <code>AddAssign</code>. Also the old name on some replacements for deprecated functions. And I think some other uses have been proposed too.</p>



<a name="236990816"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236990816" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Mario Carneiro <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236990816">(May 01 2021 at 18:54)</a>:</h4>
<p>How about "equivalent in language X"?</p>



<a name="236990942"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236990942" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> The 8472 <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236990942">(May 01 2021 at 18:57)</a>:</h4>
<p>once aliases are added for multiple languages that might be too wordy.<code> &lt;language logo&gt;: &lt;alias&gt;</code>, if it has a logo.</p>



<a name="236995613"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/236995613" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> bstrie <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#236995613">(May 01 2021 at 20:18)</a>:</h4>
<p>that seems a bit too elaborate, not everything has a universal logo or a recognizable logo (javascript, posix). either way you need to print the string, so I don't see much use in the logo</p>



<a name="237002846"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/237002846" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#237002846">(May 01 2021 at 21:37)</a>:</h4>
<p>I would just do the name of the language: <code>posix: chdir</code></p>



<a name="237040702"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/237040702" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Mara <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#237040702">(May 02 2021 at 09:32)</a>:</h4>
<p>the problem is that we still need to decide which languages/standards we're going to refer to, and what we consider 'equivalent'. we simply do not have the bandwidth or knowledge to maintain these mappings for every popular language in existence. and even if we did, it's not clear at all what 'the equivalent of a python dict' is for example. depends entirely on which properties of that type are relevant.</p>



<a name="237040766"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/237040766" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Mara <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#237040766">(May 02 2021 at 09:34)</a>:</h4>
<p>a python-&gt;rust cheat sheet would need to contain a bit of an explanation about in which ways things are and aren't the same. that kind of context/explanation does not fit in <code>doc(alias = "python: thing")</code>.</p>



<a name="237188640"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/237188640" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Lokathor <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#237188640">(May 03 2021 at 16:27)</a>:</h4>
<p>Yeah, an entire language cheat sheet is something for like an appendix chapter of The Book (one lang per page), or more likely it's just a project of its own.</p>



<a name="243793287"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/243793287" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Yuki Okushi <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#243793287">(Jun 24 2021 at 14:21)</a>:</h4>
<p>I've seen such a PR recently,  <a href="https://github.com/rust-lang/rust/issues/86554">#86554</a> or <a href="https://github.com/rust-lang/rust/issues/86596">#86596</a> for instance. It'd be great if our current standing is documented to prevent accepting aliases by mistake and lose consistency (and the docs would help us review them)</p>



<a name="243793361"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/243793361" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Yuki Okushi <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#243793361">(Jun 24 2021 at 14:22)</a>:</h4>
<p>But I'm not sure where is the best, maybe std-dev-guide?</p>



<a name="243793484"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/243793484" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Mara <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#243793484">(Jun 24 2021 at 14:23)</a>:</h4>
<p>sounds like something for the libs agenda. i'll make an issue for it</p>



<a name="243793596"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/243793596" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Yuki Okushi <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#243793596">(Jun 24 2021 at 14:23)</a>:</h4>
<p>sounds good, thanks!</p>



<a name="244085438"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/244085438" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Jubilee <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#244085438">(Jun 27 2021 at 21:18)</a>:</h4>
<p>I believe we should consider two documentation alias sets:<br>
Aliases of the form: "linear_interpolation" for "lerp" or vice versa. These are not about other programming languages, these are about literal ways to say the thing differently.<br>
Certain POSIX, Darwin, Linux, and Windows aliases instead of language aliases for OS-generic system APIs where there is an unequivocal match, especially for the cases where we already do so anyways(!)</p>



<a name="244087938"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/244087938" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Josh Triplett <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#244087938">(Jun 27 2021 at 22:18)</a>:</h4>
<p>I think "unequivocal match" is likely to be the largest source of controversy there.</p>



<a name="244087955"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/244087955" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Josh Triplett <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#244087955">(Jun 27 2021 at 22:18)</a>:</h4>
<p>That aside, though, I agree with that proposed policy.</p>



<a name="244090281"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/244090281" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> scottmcm <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#244090281">(Jun 27 2021 at 23:24)</a>:</h4>
<p><span class="user-mention silent" data-user-id="310399">Mara</span> <a href="#narrow/stream/219381-t-libs/topic/doc.20aliases/near/243793484">said</a>:</p>
<blockquote>
<p>sounds like something for the libs agenda. i'll make an issue for it</p>
</blockquote>
<p>Thanks!  I was meaning to ask about that second PR.</p>



<a name="244092057"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/219381-t-libs/topic/doc%20aliases/near/244092057" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Jubilee <a href="https://rust-lang.github.io/zulip_archive/stream/219381-t-libs/topic/doc.20aliases.html#244092057">(Jun 28 2021 at 00:16)</a>:</h4>
<p>In practice, I would expect it to be "we're notionally 'just' providing an interface to that syscall."<br>
Both of these transform things into having a policy of "provide aliases from every programming language and wind up shipping a terabyte of aliases over the next couple years" to "provide aliases to things that make sense to Rust in Rust".</p>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>